Service Redundancy Protocol Configuration Mode Commands


Service Redundancy Protocol Configuration Mode Commands
 
 
The Service Redundancy Protocol Mode is used to configure properties for Interchassis Session Recovery (ICSR) services.
 
note_smallImportant: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
 
bind
Binds the service to the IP address of the local chassis.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
bind address { IPv4 _address | IPv6_address }
[ no ] bind address
no
Removes the IP bind address.
IPv4 _address | IPv6_address
The system IP address.
note_smallImportant: Both peers must be using the same address family (IPv4 or IPv6) or the SRP connection will not establish.
Usage
Defines the IP address of the local chassis defined as part of the ICSR configuration.
Example
The following example binds the service to the IP address 1.1.1.1:
bind address 1.1.1.1
 
chassis-mode
Defines the chassis’s operational mode - primary or backup - for ICSR.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
chassis-mode { backup | primary }
[ default ] chassis-mode
default
Resets the chassis mode to the default setting of backup.
backup
Configures the system as the backup chassis operating in standby state.
primary
Configures the system as the primary chassis operating in active state.
Usage
Sets the chassis mode (primary or backup) for the system within the framework of ICSR.
Example
The following example configures the system as the primary chassis operating in active state
chassis-mode primary
 
checkpoint
Configures check pointing for ICSR.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
checkpoint session duration duration
[ default ] checkpoint session duration
default
Resets the checkpoint session duration to the default setting of 60 seconds.
duration
The amount of time (in seconds) that a call must be active before it is check pointed. duration must be an integer from 1 through 65535.
Usage
Sets the amount of time the chassis waits before check pointing an existing call session.
Example
The following example configures sets the checkpoint session duration to 6500 seconds:
checkpoint session duration 6500
 
configuration-interval
Defines the configuration validation interval.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
configuration-interval interval
[ default ] configuration-interval
default
Resets the configuration interval to the default setting of 3600 seconds.
interval
The amount of time (number of seconds) between one configuration validation and the next configuration validation. interval must be an integer from 1 through 65535.
Usage
This configures the interval between configuration validations of the primary and backup chassis.
Example
The following example sets the configuration interval to 34 seconds:
configuration-interval 34
 
dead-interval
The timeout interval before a peer is determined to be down.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
dead-interval interval
[ default ] dead-interval
default
Resets the dead interval to the default setting of 30 seconds.
interval
The amount of time (in seconds) for the dead interval. interval must be an integer from 1 through 65535.
Usage
This command specifies the amount of time that one chassis waits to receive a communication from a peer before the listening chassis determines that the peer chassis is down.
Example
The following example sets the dead interval to 65 seconds:
dead-interval 65
 
delay-interval
Configure the delay time for starting the dead timer after configuration files are loaded.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
delay-intervalinterval
[ default ] delay-interval
default
Sets / Restores default value assigned for specified parameter.
interval
The amount of time (in seconds) for the delay interval. interval must be an integer from 1 through 65535.
Usage
This configures interval for starting the dead timer after configuration files are loaded.
Example
The following example sets the delay interval to 65 seconds after the configuration files are loaded:
delay interval 65
 
end
Exits the current configuration mode and returns to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Use this command to return to the Exec mode.
 
exit
Exits the current mode and returns to the parent configuration mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Use this command to return to the parent configuration mode.
 
hello-interval
Defines the lapse time between sending the hello message.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
hello-interval interval
[ default ] hello-interval
default
Resets the hello interval to the default setting of 10 seconds.
interval
The lapse time (in seconds) between sending the hello message. interval must be an integer from 1 through 65535.
Usage
This command configures the hello interval - the amount of time that lapses between the sending of each hello message. Each chassis sends the other chassis a hello message at the expiration of every hello interval.
Example
The following example sets the hello interval to 35 seconds:
hello-interval 35
 
internal-switchover-retry-interval
Defines the interval between internal switchover retries.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
internal-switchover-retry-interval interval
[ default ] internal-switchover-retry-interval
default
Resets the internal switchover retry interval to the default setting of 60 seconds.
interval
The amount of time (number of seconds) between internal switchover retries. interval must be an integer from 10 through 120.
Usage
This configures the interval between internal switchover retries. The system only initiates internal switchovers if SRP monitoring is configured.
note_smallImportant: See the monitor authentication-probe, monitor bgp, or monitor diameter commands for more information on associated SRP monitoring.
Example
The following example sets the internal switchover retry interval to 34 seconds:
internal-switchover-retry-interval 34
 
monitor authentication-probe
Enables SRP monitoring of the connection between the specified AAA server and the primary chassis.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
[ no ] monitor authentication-probe context context_name { IPv4_address | IPv6_address } [ port port_number ]
no
Turns off the monitoring.
context context_name
Identifies the context being used. context_name must be an existing context and between 1 and 79 alpha and/or numeric characters.
IPv4 _address | IPv6_address
Defines the IP address of the AAA server to be monitored.
port port_number
Identifies a specific port for the authentication probe. port_number must be the port for the AAA server and an integer from 1 to 65535.
Usage
This command initiates monitoring of the connection between the primary chassis and the specified AAA server through the use of authentication probe packets. If the connection drops, the standby chassis becomes active.
Example
The following example initiates the connection monitoring between the primary chassis and AAA server 1.2.3.4 at port 1025:
monitor authentication-probe context test1 1.2.3.4 port 1025
 
monitor bgp
Enables SRP monitoring of the connection between the specified BGP peer and the primary chassis.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
[ no ] monitor bgp context context_name { IPv4_address | IPv6_address } [ vrf vrf_name ]
no
Disables monitoring.
context context_name
Identifies the context being used. context_name must be an existing context and between 1 and 79 alpha and/or numeric characters.
IPv4 _address | IPv6_address
Defines the IP address of the BGP peer to be monitored.
vrf vrf_name
Defines the VPN Routing/Forwarding instance.
Usage
This command initiates monitoring of the connection between the primary chassis and the specified BGP peer in the specified context. If the connection drops, the standby chassis becomes active.
Example
The following example initiates the connection monitoring between the primary chassis and BGP peer 125.2.1.56:
monitor bgp context test 125.2.1.56
 
monitor diameter
Enables SRP monitoring of the connection between the specified DIAMETER server and the primary chassis.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
[ no ] monitor diameter context context_name endpoint endpoint_name [ fqdn fqdn | peer { IPv4_address | IPv6_address } ] [ port port_number ]
no
Turns off the monitoring.
context context_name
Identifies the context being used. context_name must be an existing context and between 1 and 79 alpha and/or numeric characters.
endpoint endpoint_name
Identifies the endpoint being used. endpoint_name must be for the DIAMETER server and between 1 and 63 alpha and/or numeric characters.
fqdn fqdn
Identifies a Fully Qualified Domain Name (FQDN). fqdn must be for the DIAMETER server and between 1 and 127 alpha and/or numeric characters.
peer { IPv4 _address | IPv6_address }
Defines the IP address of the DIAMETER server to be monitored.
port port_number
Identifies a specific port to monitor. port_number must be the port for the DIAMETER server and an integer from 1 to 65535.
Usage
This command initiates monitoring of the connection between the primary chassis and the specified DIAMETER server in the specified context. If the connection drops, the standby chassis becomes active.
note_smallImportant: Endpoint name, FQDN, IP address, and port must all match the DIAMETER protocol configured values for the peer state to be updated.
Example
The following example initiates the connection monitoring between the primary chassis and the DIAMETER server on context test1 and endpoint end2:
monitor diameter context test1 5.6.7.8 endpoint end2
 
num-internal-switchover-retry
Defines the number of times an internal switchover would be retried.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
num-internal-switchover-retry retries
[ default ] num-internal-switchover-retry
default
Resets the configuration interval to the default setting of 3 retries.
retries
The number of times an internal switchover would be retried in case of standby chassis. retries must be an integer from 1 through 10.
Usage
This configures the number of times an internal switchover would be retried in case of standby chassis failure to respond or become active.
Example
The following example sets the retry number to 5:
num-internal-switchover-retry 5
 
peer-ip-address
Specifies the IP address for the peer chassis.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
peer-ip-address { IPv4_address | IPv6_address }
[ no ] peer-ip-address
no
Removes the peer IP address of the backup chassis.
IPv4_address | IPv6_address
The IP address of the backup chassis.
note_smallImportant: Both peers must be using the same address family (IPv4 or IPv6) or the SRP connection will not establish.
Usage
This command is used to identify the peer chassis in the ICSR configuration. From the primary’s perspective, the peer is the backup and from the backup’s perspective, the peer is the primary.
Example
The following example specifies 1.2.3.4 as a backup peer system to the primary system:
peer-ip-address 1.2.3.4
 
priority
Sets the initial ICSR priority of each peer chassis.
note_smallImportant: priority takes affect only during simultaneous initializing of all chassis in an ICSR configuration, and only if a misconfiguration has both chassis in the same mode (both Primary or both Backup).
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
priority priority_value
[ default ] priority
default
Resets the priority to the default setting of 125.
priority_value
The priority for the chassis. priority_value must be an integer from 1 through 255.
Usage
This command determines which chassis transitions to the Active state when all chassis have the same mode configuration. priority acts as a tie breaker for the state determination only when all chassis initialize simultaneously. The chassis with the higher priority (higher number) becomes Active while the chassis with the lower priority (lower number) becomes Standby.
Once chassis become operational (after initialization), if there is an event requiring a chassis change of state, then each chassis returns to its previous state (Active or Standby) after both chassis recover.
Example
The following example sets the priority value to 5:
priority 5
 
route-modifier
Sets the route modifier for the peer chassis.
Product
All products supporting ICSR
Privilege
Security Administrator, Administrator
Syntax
route-modifier threshold threshold_value
[ default ] route-modifier
default
Resets the route modifier to the default setting of 16.
threshold_value
The value that causes the route-modifier counter to be reset to the initial value. threshold_value must be an integer from 2 through 32.
Usage
This command is used to determine when the route modifier should be reset to its initial value to avoid rollover.
Example
The following example sets the route modifier threshold to 10:
route-modifier threshold 10
 
 

Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883